﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="The .cordll command controls managed code debugging and the Microsoft .NET common language runtime (CLR)."/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>.cordll (Control CLR Debugging)</title>

<meta name="MS-HAID" content="r19_metacmds_A_219f5977-3a08-4ca8-a088-b3ebb4546072.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(2074);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/_cordll__control_clr_debugging_.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="_copysym__copy_symbol_files_.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="_crash__force_system_crash_.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="debugger_commands.htm">Debugger Commands</A> &gt; <A href="meta_commands.htm">Meta-Commands</A> &gt; </div>
	<div id="winchm_template_title">.cordll (Control CLR Debugging)</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>The <b>.cordll</b> command controls managed code debugging and the Microsoft .NET common language runtime (CLR).</p>
<pre class="syntax"><b>.cordll </b>[<i>Options</i>]</pre>
<h2><a id="Parameters"></a><a id="parameters"></a><a id="PARAMETERS"></a>Parameters</h2>
<p></p>
<dl>
<dt><a id="_______Options______"></a><a id="_______options______"></a><a id="_______OPTIONS______"></a>       <i>Options</i>      </dt>
<dd>
<p>One or more of the following options:</p>
<p></p>
<dl>
<dt><a id="-l___lower-case_L_"></a><a id="-l___lower-case_l_"></a><a id="-L___LOWER-CASE_L_"></a><b>-l</b>  (lower-case L)</dt>
<dd>
<p>Loads the CLR debugging modules.</p>
</dd>
<dt><a id="-I_Module___upper-case_i__"></a><a id="-i_module___upper-case_i__"></a><a id="-I_MODULE___UPPER-CASE_I__"></a><b>-I</b><b> </b><i>Module</i>  (upper-case i) </dt>
<dd>
<p>Specifies the name or base address of the CLR module to be debugged. For more information, see Remarks.</p>
</dd>
<dt><a id="-u"></a><a id="-U"></a><b>-u</b></dt>
<dd>
<p>Unloads the CLR debugging modules.</p>
</dd>
<dt><a id="-e"></a><a id="-E"></a><b>-e</b></dt>
<dd>
<p>Enables CLR debugging.</p>
</dd>
<dt><a id="-d"></a><a id="-D"></a><b>-d</b></dt>
<dd>
<p>Disables CLR debugging.</p>
</dd>
<dt><a id="-D"></a><a id="-d"></a><b>-D</b></dt>
<dd>
<p>Disables CLR debugging and unloads the CLR debugging modules.</p>
</dd>
<dt><a id="-N"></a><a id="-n"></a><b>-N</b></dt>
<dd>
<p>Reloads the CLR debugging modules.</p>
</dd>
<dt><a id="-lp_Path"></a><a id="-lp_path"></a><a id="-LP_PATH"></a><b>-lp</b><b> </b><i>Path</i></dt>
<dd>
<p>Specifies the directory path of the CLR debugging modules.</p>
</dd>
<dt><a id="-se"></a><a id="-SE"></a><b>-se</b></dt>
<dd>
<p>Enables using the short name of the CLR debugging module, mscordacwks.dll.</p>
</dd>
<dt><a id="-sd"></a><a id="-SD"></a><b>-sd</b></dt>
<dd>
<p>Disables using the short name of the CLR debugging module, mscordacwks.dll. Instead, the debugger uses the long name of the CLR debugging module, mscordacwks_&lt;spec&gt;.dll. Turning off short name usage enables you to avoid having your local CLR used if you are concerned about mismatches.</p>
</dd>
<dt><a id="-ve"></a><a id="-VE"></a><b>-ve</b></dt>
<dd>
<p>Turns on verbose mode for CLR module loading.</p>
</dd>
<dt><a id="-vd"></a><a id="-VD"></a><b>-vd</b></dt>
<dd>
<p>Turns off verbose mode for CLR module loading.</p>
</dd>
</dl>
</dd>
</dl>
<h3><a id="Environment"></a><a id="environment"></a><a id="ENVIRONMENT"></a>Environment</h3>
<table>
<tr>
<td>
<p><b>Modes</b></p>
</td>
<td>
<p>User mode, kernel mode</p>
</td>
</tr>
<tr>
<td>
<p><b>Targets
         </b></p>
</td>
<td>
<p>Live, crash dump</p>
</td>
</tr>
<tr>
<td>
<p><b>Platforms</b></p>
</td>
<td>
<p>All </p>
</td>
</tr>
</table>
<p> </p>
<h2>Remarks</h2>
<p>To debug a managed application, the debugger must load a data access component (DAC) that corresponds to the CLR that the application has loaded. However, in some cases, the application loads more than one CLR. In that case, you can use the <b>I</b> parameter to specify which DAC the debugger should load. Version 2 of the CLR is named Mscorwks.dll, and version 4 of the CLR is named Clr.dll. The following example shows how to specify that the debugger should load the DAC for version 2 (mscorwks).</p>
<div class="code"><span codelanguage=""><table>
<tr>
<th></th>
</tr>
<tr>
<td>
<pre>.cordll -I mscorwks -lp c:\dacFolder</pre>
</td>
</tr>
</table></span></div>
<p>If you omit the <b>I</b> parameter, the debugger uses version 4 by default. For example, the following two commands are equivalent.</p>
<div class="code"><span codelanguage=""><table>
<tr>
<th></th>
</tr>
<tr>
<td>
<pre>.cordll -lp c:\dacFolder
.cordll -I clr -lp c:\dacFolder</pre>
</td>
</tr>
</table></span></div>
<p>Sos.dll is a component that is used for debugging managed code. The current version of Debugging Tools for Windows does not include any version of sos.dll. For information about how to get sos.dll, see <a href="#Bookmark1373">Getting the SOS Debugging Extension (sos.dll)</a>.</p>
<p>The <b>.cordll</b> command is supported in kernel-mode debugging. However, this command might not work unless the necessary memory is paged in. </p>
<h2><a id="see_also"></a>See also</h2>
<dl>
<dt><a href="#Bookmark1373">Debugging Managed Code Using the Windows Debugger</a></dt>
<dt><a href="http://go.microsoft.com/fwlink/p/?linkid=223345">SOS Debugging Extension</a></dt></dl></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
